10.5 修改角色(支持增量修改)
请求参数
Path: /api/v1/role/update
Method: POST
接口描述:
- 对于更新接口中的非必须参数,如果不传,不会对该条数据相对应参数进行修改
请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 必须 |
Body
注意: 1. 各个样例之间为并列关系, 实际发送请求时只需参照其中某一个即可
根据id更新
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
id | string | 必须 | 角色ID | ||
description | string | 非必须 | 描述 | ||
resourceGrpIdEditWay | string | 非必须 | 'set' | 应用分类编辑方式,'set'重置,'append'追加,'delete'删除 | |
resourceGrpList | string[] | 非必须 | 应用分类ID列表 | ID列表和名称列表传一个即可,如果都传,以ID列表为准 | |
resourceGroupNameList | string[] | 非必须 | 应用分类名列表 | ID列表和名称列表传一个即可,如果都传,以ID列表为准 | |
resourceIdEditWay | string | 非必须 | 'set' | 应用编辑方式,'set'重置,'append'追加,'delete'删除 | |
resourceList | string[] | 非必须 | 应用列表 | ID列表和名称列表传一个即可,如果都传,以ID列表为准 | |
resourceNameList | string[] | 非必须 | 应用名列表 | ID列表和名称列表传一个即可,如果都传,以ID列表为准 |
根据name更新
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
name | string | 必须 | 角色名字 | ||
description | string | 非必须 | 描述 | ||
resourceGrpIdEditWay | string | 非必须 | 'set' | 应用分类编辑方式,'set'重置,'append'追加,'delete'删除 | |
resourceGrpList | string[] | 非必须 | 应用分类ID列表 | ID列表和名称列表传一个即可,如果都传,以ID列表为准 | |
resourceGroupNameList | string[] | 非必须 | 应用分类名列表 | ID列表和名称列表传一个即可,如果都传,以ID列表为准 | |
resourceIdEditWay | string | 非必须 | 'set' | 应用编辑方式,'set'重置,'append'追加,'delete'删除 | |
resourceList | string[] | 非必须 | 应用列表 | ID列表和名称列表传一个即可,如果都传,以ID列表为准 | |
resourceNameList | string[] | 非必须 | 应用名列表 | ID列表和名称列表传一个即可,如果都传,以ID列表为准 |
请求示例
{
"id": "822a63d0-5b8b-11eb-ab31-83fd8f2a64ca",
"name": "新角色222",
"description": "这是新角色",
"resourceGrpList": [],
"resourceList": ["0e8cec60-5585-11eb-9aa3-27b058cac48b", "c4f643f0-5717-11eb-b6e0-f7651d8dccc0"]
}
返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | number | 必须 | 错误码,非0表示错误,具体含义请参考错误码定义 | ||
data | object | 必须 | 返回内容 | ||
msg | string | 必须 | 描述信息 |
返回示例
{
"code": 0,
"data": {
"data": [1]
},
"msg": "请求成功"
}
错误信息
错误提示 | 错误码 |
---|---|
参数检查出错 | 10000001 |
名称不能为空 | 10000001 |
角色不存在 | 77200004 |
操作失败,对象不存在或已被其他管理员删除 | 77200004 |
角色名(%s)已存在 | 77200005 |
保存失败,授权的应用不存在 | 77200004 |
保存失败,授权的应用分类不存在 | 77200004 |
角色最多关联2000个应用 | 77200004 |
操作失败 | 10000000 |